home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 5 / pcdbms12.zip / ADDENDUM.TXT next >
Text File  |  1985-09-18  |  17KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.              Addendum to PC-DBMS User's Guide
  11.  
  12.  
  13. This  addendum  updates  the  version 1.0 User's Guide to
  14. reflect changes up to version 1.2.
  15.  
  16. In the version 1.0 distribution,  the  User's  Guide  was
  17. provided  in  the  files  MANUAL.1 and MANUAL.2.  In this
  18. (version 1.2) distribution,  it may be in a  single  file
  19. called  PC-DBMS.DOC.  Only  two changes have been made to
  20. the Guide.  First, the three occurrences of "=>" on pages
  21. 3-4 and 3-5 have been corrected to read ">=".  This error
  22. caused some users to think PC-DBMS couldn't  process  its
  23. own  where  clause.  Second,  Appendix C,  User Supported
  24. Software,  has been updated to reflect unbundling of  PC-
  25. DBMS  and  lower  prices.  That appendix is reproduced in
  26. the addendum.  If you already have a  User's  Guide,  you
  27. may wish to skip printing PC-DBMS.DOC (or MANUAL.*).
  28.  
  29. In  addition  to  the  new  Appendix  C,   this  addendum
  30. describes  changes  and  extensions  to  the  version 1.0
  31. program.  Bug fixes are documented in RELNOTES.TXT.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. DISTRIBUTION DISKETTE
  75.  
  76. The distribution diskette contains  the  files  shown  in
  77. Figure 1.
  78.  
  79. READ.ME         getting started
  80. PC-DBMS.DOC     User's Guide (or MANUAL.1 & MANUAL.2)
  81. RELNOTES.TXT    description of changes in this version
  82. ADDENDUM.TXT    this file
  83. MUSIC.DEF       a sample data base
  84. COMPOSER.DAT            for the tutorial
  85. OPUS.DAT                       in the User's Guide
  86. PC-DBMS.EXE     the dbms program
  87. PC-DBMS.SMP     sample start-up file
  88. REQUEST.DOC     order/payment form and invoice
  89.  
  90. Figure 1.  Files on the distribution diskette.
  91.  
  92.  
  93.  
  94. MISSING FILE ERROR HANDLING
  95.  
  96. When PC-DBMS fails to find a data or index file,  it will
  97. so report and halt execution of the command.
  98.  
  99.  
  100. RECORD COUNTS
  101.  
  102. The select,  display,  pack and key commands can  process
  103. existing data table records sequentially,  i.e.,  without
  104. index look-ups.  Previous versions processed  the  number
  105. of  records  shown  in  the  schema  if  that  count  was
  106. consistent  with  the  file  size  and   record   length.
  107. Occasionally,  records  added by other other applications
  108. to narrow tables were ignored as a result.
  109.  
  110. Beginning with version 1.2,  all records are read.  Those
  111. beginning  with  a  backslash or a null are ignored.  The
  112. backslash records are marked  as  deleted  and  the  null
  113. records   are  inserted  by  PC-DBMS  and  certain  other
  114.  
  115.                             2   
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139. programs to fill files to 128 byte boundaries.
  140.  
  141.  
  142. SELECT AND SHOW COMMANDS
  143.  
  144. In the select command,  the wildcard indicator *  can  be
  145. used in place of ALL.
  146.  
  147. In  the select and show commands,  control num-lock still
  148. halts scrolling but control-S no longer does.
  149.  
  150.  
  151. PACK COMMAND
  152.  
  153. The deletion of data records and the  removal  of  tables
  154. (with the remove command) leaves unused space in data and
  155. schema  files,  respectively.  The  pack command recovers
  156. that space by pushing undeleted data  or  schema  records
  157. passed  deleted  ones.  It  then truncates the file.  The
  158. syntax is:
  159.  
  160.         PACK  [\SCHEMA]  [table-name ...]
  161.  
  162. To pack the schema file,  append the qualifier \schema to
  163. the keyword pack.  If the qualifier is not specified,  at
  164. least one table name must be given.
  165.  
  166. For example,
  167.  
  168.         PACK\SCH  COMP OPUS
  169.  
  170. packs the schema and two data files.
  171.  
  172. The pack command will also delete trailing  nulls  (ascii
  173. zeros)  which  PC-DBMS  uses  to  pad files to a 128 byte
  174. boundary.
  175.  
  176. When a data file is  packed  the  schema's  record  count
  177. (which  includes deleted records) is updated.  The change
  178. is apparent when the show command is executed.
  179.  
  180.  
  181.                             3   
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205. It is necessary to remove indices on files to  be  packed
  206. because  indices  store  record  numbers and these change
  207. during packing.  The schema will be  updated  to  show  a
  208. previously  keyed  field  as  unkeyed  and the associated
  209. index file will be deleted.  However, if the packing does
  210. not change record numbers (no deleted records before  the
  211. last  undeleted  record),  no  change will be made to the
  212. index file or the schema keying information.
  213.  
  214.  
  215. THE INITIALIZATION FILE
  216.  
  217. After PC-DBMS presents its welcome screen, it attempts to
  218. find and  read  a  file  called  PC-DBMS.INI.  This  file
  219. specifies  the  video attributes for various parts of the
  220. main screen  and  the  display  utility's  screen.  These
  221. parts  are  called  screen  items.  Video  attributes are
  222. characteristics such as bright,  color or reverse  video.
  223. Without an initialization file,  PC-DBMS will use default
  224. video attributes.  Also,  the initialization file can set
  225. the  command window editing default to overstrike instead
  226. of pushright.
  227.  
  228.  
  229. 1.  Specifying Video Attributes
  230.  
  231. Even color systems (color board and color monitor) do not
  232. require  the  initialization  file.  However,  they  will
  233. behave  like  monochrome without it.  If you have a color
  234. system,  you can use a text editor to create a file  with
  235. just  these two characters in it:  %C.  Name the file PC-
  236. DBMS.INI and keep it in the current directory or  in  any
  237. subdirectory  named  in the path command.  You'll get the
  238. default colors.  If the defaults  are  satisfactory,  you
  239. need read no further regardless of the kind of system you
  240. have.
  241.  
  242. There are three display system types:
  243.  
  244.  
  245.  
  246.  
  247.                             4   
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273. (1) monochrome board and monochrome (single color)
  274.     monitor,
  275. (2) color board and monochrome monitor, and
  276. (3) color board and multi-color monitor.
  277.  
  278. PC-DBMS   has   a  distinct  set  of  screen  item  video
  279. attributes for each system.  System (1) is easy  for  PC-
  280. DBMS  to  identify  but  the other two look alike because
  281. software can't tell what kind of monitor  you  have.  The
  282. %C  flag  solves  that  problem  by  indicating  a  color
  283. monitor.  (The color monitor flag will be ignored if  you
  284. have a monochrome board.)
  285.  
  286. Figure 2 shows a sample initialization file.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.                             5   
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339. %C    full color, please!
  340. %E    overstrike editing
  341.  
  342.             color   color    (Monochrome columns
  343.    mono-    board,  board,    have default values.
  344.    chrome    mono   color     The values could
  345.    board    screen  screen    have been omitted,
  346.    ------   ------  ------    leaving only commas.)
  347.  
  348. &A    7,       7,     30       display screen: background
  349. &B  112,     112,     12       display screen: blocks
  350. &C   15,      15,     78       command window: frame
  351. &D    7,       7,     71       command window: interior
  352. &E  112,     112,    103       main screen: top rt menu
  353. &F     ,     112,     88       message stripe
  354. &G    1,       7,    112       column headings stripe
  355. &H  112,     112               output window
  356.  
  357. Figure 2.  An initialization file.
  358.  
  359.  
  360. There  are eight screen items which can be assigned video
  361. attributes.  The interior of  the  command  window  is  a
  362. screen  item,  for example.  The screen items are denoted
  363. by the flags &A-&H.  They are defined by the comments  in
  364. Figure 2.
  365.  
  366. Each screen item gets its own line in the file.  However,
  367. you  can omit any of the screen item lines.  For example,
  368. the &E row could have  been  omitted.  Defaults  will  be
  369. assumed.
  370.  
  371. There  are  256 possible video attributes numbered 0-255.
  372. Their construction is shown in Figure 3.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                             6   
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.     Video Attributes for Systems (1) and (2)
  405.  
  406.   Attribute               Value        Comment
  407.  
  408. Underlined                    1     system (1) only
  409. Normal (white on black)       7
  410. Underlined bright             9     system (1) only
  411. Normal bright                15
  412. Reverse (black on white)    112
  413. Reverse bright              120
  414.  
  415.  
  416.      Video Attributes for System (3)
  417.  
  418. Color        Foreground         Background
  419.  
  420. Black             0                  0
  421. Blue              1                 16
  422. Green             2                 32
  423. Cyan              3                 48
  424. Red               4                 64
  425. Magenta           5                 80
  426. Brown             6                 96
  427. White             7                112
  428. Gray              8
  429. Lt blue           9
  430. Lt green         10
  431. Lt cyan          11
  432. Lt red           12
  433. Lt magenta       13
  434. Yellow           14
  435. Bright white     15
  436.  
  437. The attribute value is the sum of the
  438. foreground and background numbers.
  439.  
  440. For all system types, add 128 to the
  441. attribute value for blinking.
  442.  
  443. Figure 3.  Construction of Video Attribute Values.
  444.  
  445.                             7   
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. The initialization file can specify  one,  two  or  three
  472. video  attribute  numbers  per  screen  item.  The  three
  473. numbers   correspond   to   the   three   system   types,
  474. respectively.  Hence,  a  single  initialization file can
  475. work on any kind of system.
  476.  
  477. You can omit a number.  It will assume the default value.
  478. See the &F and &H lines in Figure  2,  for  example.  The
  479. first  comma  in  line  &F  serves  as  a necessary place
  480. holder.  A trailing comma is unneeded.  See line &H.
  481.  
  482. Each flag must be flush  left.  There  must  be  a  comma
  483. between numbers.  Space(s) can precede numbers or commas.
  484. Comments  can  be  inserted.  There is no special comment
  485. marker  and  a  comment  ends  parsing  of  a  line  when
  486. encountered.
  487.  
  488. All default values are shown in Figure 4.
  489.  
  490.  
  491.             color   color
  492.    mono-    board,  board,
  493.    chrome    mono   color
  494.    board    screen  screen
  495.    ------   ------  ------
  496.  
  497. &A    7,      7,     30
  498. &B  112,    112,     12
  499. &C   15,     15,     14
  500. &D    7,      7,      3
  501. &E  112,    112,    112
  502. &F  112,    112,     71
  503. &G    1,      7,    112
  504. &H  112,    112,     30
  505.  
  506. Figure 4.  Default video attributes
  507.  
  508.  
  509.  
  510.  
  511.                             8   
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536. 2.  Changing the Editing Default
  537.  
  538. The  editor  in  the command window uses pushright as its
  539. default.  If you wish the default to be overstrike,  just
  540. put these two characters at the beginning of any start-up
  541. file line: %E.  See Figure 2.
  542.  
  543.  
  544. 3.  Creating a Start-up File
  545.  
  546. The  PC-DBMS  distribution  includes   PC-DBMS.SMP,   the
  547. initialization  file  I  use.  Most  but  not  all of its
  548. values are the defaults.  It is an easy starting point to
  549. develop your own initialization file.  Use the  DOS  copy
  550. command
  551.  
  552.     A> copy  pc-dbms.smp  *.ini
  553.  
  554. to  produce a version which PC-DBMS will read.  (Note the
  555. new name assigned in the copy command.) The file must  be
  556. in  the current directory or in one of the subdirectories
  557. specified in a path command.  If yours is a  system  (2),
  558. remove the color flag %C with a text editor.  Execute PC-
  559. DBMS  and  see  which  video attributes you would like to
  560. change.  Exit PC-DBMS and edit  the  file.  Repeat  until
  561. happy.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.                             9   
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.                        APPENDIX C
  610.  
  611.                  USER SUPPORTED SOFTWARE
  612.  
  613.  
  614.  
  615. PC-DBMS is distributed as user  supported  software.  You
  616. are   encouraged  to  give  copies  of  the  distribution
  617. diskette for others.  There is no license  agreement  but
  618. please  pass  along all files without modification.  User
  619. groups and similar organizations  may  impose  a  nominal
  620. charge to cover the cost of duplication.
  621.  
  622. The user supported concept of software is  a  significant
  623. innovation  (not  mine)  which  benefits  both  user  and
  624. author.  For  the  user,  there  is  the  convenience  of
  625. leisurely evaluation of the program on your own system in
  626. your own home or office to see if  it's  right  for  your
  627. application.   The  low  cost  of user supported software
  628. distribution also  makes  possible  a  voluntary  payment
  629. lower  than  the  price  of commercial software.  And, of
  630. course,  there's  no  copy  protection  to  diminish  the
  631. utility of the program.
  632.  
  633. For the author, there is the satisfaction  of  getting  a
  634. far  larger  number  of  copies into use than is possible
  635. with conventional marketing.  Also, the  interference  of
  636. piracy is turned into a reinforcement in the distribution
  637. of the program.   Finally,  if  you  have  dealt  with  a
  638. publisher,   print  or  electronic,  you  understand  the
  639. undesirability of that alternative.
  640.  
  641. However,  it doesn't work unless you want it to.  If  you
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                  USER SUPPORTED SOFTWARE
  664.  
  665.  
  666.  
  667. find PC-DBMS useful, I hope you will register by making a
  668. voluntary  payment of $35,  by check or through your bank
  669. credit card.  Beyond what you already have,  this is what
  670. you will receive from me.
  671.  
  672.       -  Support  for a year.  Comments,  suggestions and
  673.          especially bug reports are welcome from  anyone.
  674.          However,   only   registered  users  can  expect
  675.          replies to  their  questions.  Support  will  be
  676.          provided  on  a  best  efforts basis by mail and
  677.          through  CompuServe.   My   CompuServe   id   is
  678.          74216,3033.
  679.  
  680.       -  Notices  of  subsequent PC-DBMS releases.  Disks
  681.          and documentation will be available as indicated
  682.          below.
  683.  
  684.       -  My thanks.  PC-DBMS took a year to develop, test
  685.          and document.  I enjoyed every minute of it.
  686.  
  687.  
  688. Now,  I ask that you send your voluntary payment with the
  689. order/payment  form.  A  copy of that form is on the next
  690. page or, if you wish to leave your manual intact, another
  691. copy is in the file REQUEST.DOC.  If you need an invoice,
  692. you'll find one following the order/payment form in  both
  693. the manual and in REQUEST.DOC.
  694.  
  695. IF YOU REGISTER BY FEBRUARY 1,  1986,  WE WILL SEND YOU A
  696. FREE COPY OF THE TYPESET USER'S GUIDE.
  697.  
  698. For  quantity purchases of PC-DBMS or to distribute it in
  699. conjunction with your data base, contact Kware.
  700.  
  701. Whether or not you register,  you are welcome to purchase
  702. the     typeset     User's    Guide    ($10)    or    the
  703. program/documentation   disk   ($10)   or   both   ($18).
  704. Purchasing  materials is one way to support the continued
  705. development of PC-DBMS and to keep yourself supplied with
  706. the most current version.
  707.  
  708.  
  709.                            C-2   
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                  USER SUPPORTED SOFTWARE
  730.  
  731.  
  732.  
  733. One way to keep current is to pre-order the next release.
  734. It  will  be  sent to you as soon as it's issued.  You'll
  735. get it faster and more  reliably  than  through  bulletin
  736. boards  and user groups.  Just mark "next release" on the
  737. applicable line of the order/payment form.
  738.  
  739. To  register  or to order materials,  enter your name and
  740. address on the form below  and  indicate  the  quantities
  741. desired of the various items in the quantity column.  Pay
  742. by check or complete the credit card form.
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.                            C-3   
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                  USER SUPPORTED SOFTWARE
  796.  
  797.  
  798.  
  799.  
  800.                     ORDER/PAYMENT FORM
  801.  
  802.  
  803. Name    _____________________________  Phone ____________
  804.  
  805. Company _____________________________
  806.  
  807. Address _____________________________
  808.  
  809.         _____________________________
  810.  
  811. City    _________________  State ________  Zip _________
  812.  
  813.  
  814. Description        Qty      Price       Extension
  815. -----------        ---      -----       ---------
  816.  
  817. registration                $35.00
  818.  
  819. User's Guide                 10.00
  820.  
  821. PC-DBMS disk                 10.00
  822.  
  823. Guide & disk                 18.00
  824.                                         ---------
  825.                    Sub-total
  826.  
  827. Tax @ 4%  (Va. residents only)
  828.                                         ---------
  829.                    Amount due
  830.  
  831.  
  832. Kware                           Please make check payable
  833. P.O. Box 16206                  to Kware or complete
  834. Arlington, Va. 22215            credit card form below.
  835.  
  836.  
  837. Visa  __   or Mastercard __   card #  ___________________
  838.  
  839. exp mo/yr  ______/______  signature  ____________________
  840.  
  841.                            C-4   
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                  USER SUPPORTED SOFTWARE
  862.  
  863.  
  864.  
  865.  
  866.                       INVOICE
  867.  
  868.  
  869. Vendor:  Kware, Inc.              Federal EIN: 54-1304150
  870.          P. O. Box 16206
  871.          Arlington, Va. 22215     Date:    /    /
  872.  
  873.  
  874. Description        Qty      Price       Extension
  875. -----------        ---      -----       ---------
  876.  
  877. PC-DBMS,                    $35.00
  878.  reg & support
  879.  
  880. User's Guide                 10.00
  881.  
  882. PC-DBMS disk                 10.00
  883.  
  884. User's Guide                 18.00
  885.  & disk
  886.                                         ---------
  887.                    Sub-total
  888.  
  889. Tax @ 4%  (Va. residents only)
  890.  
  891.                                         ---------
  892.                    Amount due
  893.  
  894.  
  895.  
  896. You may retain this invoice.
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.                            C-5   
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.